home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1997 April / macformat-049.iso / mac / Shareware Plus / Developers / dropg++ / usr / include / sys / ktrace.h < prev    next >
Encoding:
C/C++ Source or Header  |  1997-02-20  |  4.2 KB  |  157 lines  |  [TEXT/R*ch]
  1. /*
  2.  * Copyright (c) 1988, 1993
  3.  *    The Regents of the University of California.  All rights reserved.
  4.  *
  5.  * Redistribution and use in source and binary forms, with or without
  6.  * modification, are permitted provided that the following conditions
  7.  * are met:
  8.  * 1. Redistributions of source code must retain the above copyright
  9.  *    notice, this list of conditions and the following disclaimer.
  10.  * 2. Redistributions in binary form must reproduce the above copyright
  11.  *    notice, this list of conditions and the following disclaimer in the
  12.  *    documentation and/or other materials provided with the distribution.
  13.  * 3. All advertising materials mentioning features or use of this software
  14.  *    must display the following acknowledgement:
  15.  *    This product includes software developed by the University of
  16.  *    California, Berkeley and its contributors.
  17.  * 4. Neither the name of the University nor the names of its contributors
  18.  *    may be used to endorse or promote products derived from this software
  19.  *    without specific prior written permission.
  20.  *
  21.  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  22.  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23.  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24.  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  25.  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  26.  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  27.  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  28.  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  29.  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  30.  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  31.  * SUCH DAMAGE.
  32.  *
  33.  *    @(#)ktrace.h    8.1 (Berkeley) 6/2/93
  34.  */
  35.  
  36. /*
  37.  * operations to ktrace system call  (KTROP(op))
  38.  */
  39. #define KTROP_SET        0    /* set trace points */
  40. #define KTROP_CLEAR        1    /* clear trace points */
  41. #define KTROP_CLEARFILE        2    /* stop all tracing to file */
  42. #define    KTROP(o)        ((o)&3)    /* macro to extract operation */
  43. /*
  44.  * flags (ORed in with operation)
  45.  */
  46. #define KTRFLAG_DESCEND        4    /* perform op on all children too */
  47.  
  48. /*
  49.  * ktrace record header
  50.  */
  51. struct ktr_header {
  52.     int    ktr_len;        /* length of buf */
  53.     short    ktr_type;        /* trace record type */
  54.     pid_t    ktr_pid;        /* process id */
  55.     char    ktr_comm[MAXCOMLEN+1];    /* command name */
  56.     struct    timeval ktr_time;    /* timestamp */
  57.     caddr_t    ktr_buf;
  58. };
  59.  
  60. /*
  61.  * Test for kernel trace point
  62.  */
  63. #define KTRPOINT(p, type)    \
  64.     (((p)->p_traceflag & ((1<<(type))|KTRFAC_ACTIVE)) == (1<<(type)))
  65.  
  66. /*
  67.  * ktrace record types
  68.  */
  69.  
  70. /*
  71.  * KTR_SYSCALL - system call record
  72.  */
  73. #define KTR_SYSCALL    1
  74. struct ktr_syscall {
  75.     short    ktr_code;        /* syscall number */
  76.     short    ktr_narg;        /* number of arguments */
  77.     /*
  78.      * followed by ktr_narg ints
  79.      */
  80. };
  81.  
  82. /*
  83.  * KTR_SYSRET - return from system call record
  84.  */
  85. #define KTR_SYSRET    2
  86. struct ktr_sysret {
  87.     short    ktr_code;
  88.     short    ktr_eosys;
  89.     int    ktr_error;
  90.     int    ktr_retval;
  91. };
  92.  
  93. /*
  94.  * KTR_NAMEI - namei record
  95.  */
  96. #define KTR_NAMEI    3
  97.     /* record contains pathname */
  98.  
  99. /*
  100.  * KTR_GENIO - trace generic process i/o
  101.  */
  102. #define KTR_GENIO    4
  103. struct ktr_genio {
  104.     int    ktr_fd;
  105.     enum    uio_rw ktr_rw;
  106.     /*
  107.      * followed by data successfully read/written
  108.      */
  109. };
  110.  
  111. /*
  112.  * KTR_PSIG - trace processed signal
  113.  */
  114. #define    KTR_PSIG    5
  115. struct ktr_psig {
  116.     int    signo;
  117.     sig_t    action;
  118.     int    mask;
  119.     int    code;
  120. };
  121.  
  122. /*
  123.  * KTR_CSW - trace context switches
  124.  */
  125. #define KTR_CSW        6
  126. struct ktr_csw {
  127.     int    out;    /* 1 if switch out, 0 if switch in */
  128.     int    user;    /* 1 if usermode (ivcsw), 0 if kernel (vcsw) */
  129. };
  130.  
  131. /*
  132.  * kernel trace points (in p_traceflag)
  133.  */
  134. #define KTRFAC_MASK    0x00ffffff
  135. #define KTRFAC_SYSCALL    (1<<KTR_SYSCALL)
  136. #define KTRFAC_SYSRET    (1<<KTR_SYSRET)
  137. #define KTRFAC_NAMEI    (1<<KTR_NAMEI)
  138. #define KTRFAC_GENIO    (1<<KTR_GENIO)
  139. #define    KTRFAC_PSIG    (1<<KTR_PSIG)
  140. #define KTRFAC_CSW    (1<<KTR_CSW)
  141. /*
  142.  * trace flags (also in p_traceflags)
  143.  */
  144. #define KTRFAC_ROOT    0x80000000    /* root set this trace */
  145. #define KTRFAC_INHERIT    0x40000000    /* pass trace flags to children */
  146. #define KTRFAC_ACTIVE    0x20000000    /* ktrace logging in progress, ignore */
  147.  
  148. #ifndef    KERNEL
  149.  
  150. #include <sys/cdefs.h>
  151.  
  152. __BEGIN_DECLS
  153. int    ktrace __P((const char *, int, int, pid_t));
  154. __END_DECLS
  155.  
  156. #endif    /* !KERNEL */
  157.